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PREFACE 


This instant provides a convenient s umm ary of the 
COMPASS Version 3.6 language as implemented under the 
following operating systems: 

NOS 1 for the CONTROL DATA® CYBER 170 Computer 
Systems; CYBER 70 models 71, 72, 73, and 74, and 
6000 Computer Systems 

NOS 2 for the CDC® CYBER 170 Computer Systems; 
CYBER 70 models 71, 72, 73, and 74; and 6000 
Computer Systems 

NOS/BE 1 for the CDC CYBER 170 Computer Systems; 
CYBER 70 models 71, 72, 73, and 74; and 6000 
Computer Systems 

SCOPE 2 for the CDC CYBER 170 model 176; CYBER 70 
model 76; and 7600 Computer Systems 

This instant is written for a programmer familiar with 
the COMPASS language and the operating system under 
which the COMPASS assembler is operating. 

NOTE 

Avoid continued use of COMPASS in creating 
application programs when possible. COMPASS 
and other machine-dependent languages can 
complicate migration to future hardware and 
software systems. Software mobility will be 
restricted by continued use of COMPASS for 
stand-alone programs, COMPASS subroutines 
embedded in programs using higher-level 
languages, and COMPASS owncode routines used 
with CDC standard products. 

More detailed information can be found in the following 
publication: 


Publication 


Publication 

Number 


COMPASS Version 3 60492600 

Reference Manual 


CDC manuals can be ordered from Control Data 
Corporation, Literature and Distribution 
Services, 308 North Dale Street, St. Paul, 
Minnesota 55103. 
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COMPASS CONTROL STATEMENT 

The COMPASS control statement causes the COMPASS assem¬ 
bler to be loaded from the library and executed. The 
COMPASS control statement has the following form: 

COMPASS(parameter-list) 

where parameter-list is a list of optional parameters 
separated by commas. See table 1 for the allowable 
parameters. 


TABLE 1. COMPASS CONTROL STATEMENT PARAMETERS 


Parameter 

Option 

Significance 

A 

omitted 

A 

Do not abort 

Abort job to EXIT(S) 

(NOS/BE or SCOPE 2) or 

EXIT (NOS) if fatal errors 
occur; ignored if D is 
present 

B 

omitted or B 

B = 0 

B = filename 

Binary written on LGO 

No binary 

Binary written on filename 

BL 

omitted or 

BL = 0 

BL 

No burstable listing 

Generate burstable listing 

D 

omitted 

D 

No debug mode 

Debug mode (A parameter 
suppressed) 

E 

omitted 

E 

E = filename 

E = 0 

Error list on OUTPUT 

Error list on ERRS 

Error list on filename 

No error list 
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TABLE 1. COMPASS CONTROL STATEMENT 
PARAMETERS (Contd) 


Parameter 

Option 

Significance 

F 

omitted or F 

Special element *F is 0 


F = n 

Special element *F is n 
(decimal digit) 


F = name 

Special element *F is a 
decimal digit as follows: 

name *F 

COMPASS 0 

RUN 1 

FTN4 2 

FTN5 3 

ct 

omitted or 

G = 0 

No system text 


G 

System text on file named 
SYSTEXT 


G = filename 

System text is first over¬ 
lay on filename 


G = filename/ 

System text is named over- 


ovl 

lay on filename 

I 

omitted 

Source on INPUT 


I 

Source on COMPILE 


I = filename 

Source on filename 


o 

II 

H 

Illegal 

L 

omitted or L 

Full list on OUTPUT 


L = filename 

List on filename 


L = 0 

No full list 
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TABLE 1. COMPASS CONTROL STATEMENT 
PARAMETERS (Contd) 


Parameter 

Option 

Significance 

LO 

omitted or 

LO = 0 

Selects B, L, N and R 


LO 

Selects C, F, G, X 


LO = string 

Selects or deselects 
options in string. If 
included, B, L, N, and R 
are deselected; other op¬ 
tions are selected. Nine 
options maximum. See LIST 
pseudo instruction for 
options. 


LO = $$$$ 

Select all options 

ML 

omitted or ML 

MODLEVEL equal to JDATE 


ML = string 

MODLEVEL equal to string 
(9 characters maximum) 

N 

omitted 

Normal ejects 


N 

No explicit ejects 

0 

omitted or 0 

Short list on OUTPUT 


0 = filename 

List on filename 


0 = 0 

No short list 

P 

omitted 

New pagination on END 


P 

Continue pagination 

PC 

omitted or PC 

PCOMMENT is 30 blanks 


PC = string 

PCOMMENT is 30-character 
string 
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TABLE 1. COMPASS CONTROL STATEMENT 
PARAMETERS (Contd) 


Parameter 

Option 

Significance 

PD 

omitted or 
not 6 or 8 

Defaults to IP.PD lines 
per inch (IP.PD is an 
installation parameter.) 


PD = 6 

Print six lines per inch 


PD = 8 

Print eight lines per inch 

PS 

omitted 

If PD also omitted, de¬ 
faults to IP.PS. If PD 
specified, PS=(PD*IP.PS)/ 

IP.PD (IP.PS and IP.PD are 
installation parameters.) 


PS = x 

Page size is x lines per 
page (4<x<99) 

st 

omitted 

Text on SYSTEXT overlay in 
system library 


S 

Load overlay named SYSTEXT 
from job's global library 
set 


o 

ii 

co 

No system text 


S = ovl 

Text is named overlay on 
global library set 


S = lib/ovl 

Text is named overlay on 
specified library 

X 

omitted 

Text on OLDPL file 


X = filename 

Text on filename 


X = 0 

Illegal 


X 

Text on OPL file 

tMaximum of 7 S and G parameters allowed. 
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SOURCE STATEMENT FORMAT 


COMPASS statements consist of the location field, 
operation field, variable field, and comments field. 
The fields are not restricted to specific character 
positions of the line. 

FORMAT CONVENTIONS 

The following format conventions are optional. The 
were established to standardize the appearance of 
COMPASS programs. 

Column Contents 


1 

Comma, blank, or asterisk. 

2-9 

Location field entry, or plus or minus 
(left justified) 

10 

Blank 

11-16 

Operation field entry (left justified) 

17 

Blank 

18-29 

Variable field entry (left justified) 

30 

Beginning of comments 


FORMAT REQUIREMENTS 

The COMPASS assembler imposes less rigid requirements 
on statement format than the optional conventions 
previously described. Fields are not restricted to 

specific character positions but must be separated by 
blanks. If the location, operation, and variable 

fields are empty, the line is treated as a comment 
line. The location, operation, and variable fields 


must not extend beyond character position 72. 
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FIRST CHARACTER POSITION 


The first character position of a line determines the 
type of line: 

, (comma) 

Continuation line; maximum of nine per statement 
* (asterisk) 

Comment line 
other 

New statement 


LOCATION FIELD 

The location field begins in character position 1 or 2 
and contains a symbol, name, + (force upper), or - 
(negate force upper). The location field is terminated 
by one or more blanks. 

OPERATION FIELD 

The operation field begins with the first nonblank 
character following the location field. The operation 
field can start in character position 3 when the loca¬ 
tion field is empty. The operation field contains a 
central processor or peripheral processor mnemonic 
operation code, a pseudo instruction, or a macro name, 
or the field is blank. The operation field is termi¬ 
nated by one or more blanks. 


VARIABLE FIELD 

The variable field begins with the first nonblank 
character following the operation field. This field 
must not extend beyond character position 72. The 
field is empty if it does not begin before the comments 
field character position set by the COL pseudo instruc¬ 
tion. The variable field is terminated by one or more 
blanks. 

The variable field contains data items, expressions, 
register designators, names, special elements, or 
entries defined for the instruction. 
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COMMENTS FIELD 


The beginning of the comments field is determined as 
follows: 

If the variable field is empty, the comments field 
begins in the comments field character position 
(position 30 unless changed by the COL pseudo 
instruction). 

If the variable field is not empty, the comments 
field begins with the first nonblank character 
following the variable field. 

The comments field ends with the last non-blank char¬ 
acter on the line. 
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STATEMENT EDITING 


COMPASS reads statements from the source file, and 
immediately edits and interprets each statement (unless 
the statement is a comment line or is part of a defini¬ 
tion). COMPASS performs two types of editing: concat¬ 
enation and micro substitution. 

CONCATENATION 

The concatenation character (CDC graphic character r* ; 
ASCII graphic character ) delimits a substitutable 
parameter when no other delimiter is present. Each 
concatenation character is removed before the statement 
is interpreted. 


MICRO SUBSTITUTION 

Pairs of micro marks (CDC graphic character ASCII 
graphic character ") delimit a micro reference. Edit¬ 
ing replaces the reference, including the micro marks, 
with a character string. The empty string replaces 
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Names identify programs, overlays, blocks, macros, 
micros, remote code, or conditional or duplicated 
sequences. 

Names are terminated by a comma or blank and can be one 
through eight characters long, with the following 
exceptions: 

External linkage names are limited to a maximum of 
seven characters. 

Central processor subprogram and overlay names are 
limited to a maximum of seven characters. These 
names must begin with a letter (A through Z) . 

Peripheral processor subprogram and overlay names 
for CYBER 170 Computer Systems or CYBER 70 models 
72, 73, or 74 are limited to a maximum of three 
characters. 

Peripheral processing unit subprogram and overlay 
names for the CYBER 70 model 76 are limited to a 
maximum of seven characters. 
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SYMBOLS 


A symbol is a set of one through eight characters that 
identifies a value and its associated attributes. 

* 

A symbol cannot include the following characters: 

4- plus 
- minus 
* asterisk 
A blank 
/ slash 
, comma 

r* concatenation character 
caret 

A symbol cannot begin with: 

$ dollar sign 

= equals sign 

: colon 

1-9 digit 





The symbols An, Bn, Xn or A.m, B.m, X.m, are reserved 
as register designators in central processor programs. 


LINKAGE SYMBOLS 



Linkage symbols are external symbols and entry point 
symbols. These symbols are limited to seven charac¬ 
ters. The first character must be a letter (A through 
Z); the last character must not be a colon (:). 
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DEFAULT SYMBOLS 

Default symbols are preceded by =S, =X, or =Y and are 
defined as follows: 

=Ssymbol 

If the symbol is not defined conventionally, 
COMPASS assigns an address to the symbol; 
otherwise, the conventional definition is used. 

=Xsymbol 

If the symbol is not defined in the program, 
COMPASS assumes the symbol is a strong external; 
otherwise, the program definition is used. 

=Ysymbol 

If the symbol is not defined or referenced as 
=Xsymbol, COMPASS assumes the symbol is a weak 
external; otherwise, the program definition or 
the —X reference takes precedence. 


QUALIFIED SYMBOLS 


A symbol defined when a symbol qualifier is in effect 
during assembly can be referenced outside the qualifier 
sequence as 

/qualifier/symbol 

Unqualified symbols within a qualifier sequence can be 
referenced as //symbol. The QUAL pseudo instruction 
defines a qualifier sequence. 

=Ssymbol is qualified by the qualifier that is in 
effect. =Xsymbol and =Ysymbol are unqualified. 
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CENTRAL PROCESSOR REGISTER 
DESIGNATORS 

The following register designators are used in central 
processor programs: 

Register 

Type Designation 


Address An or A.m 
Index Bn or B.m 
Operand Xn or X.m 

In these designations, n is a single digit in the range 
0 through 7; m is a symbol or unsigned integer constant 
with a value in the range 0 through 7. 
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SPECIAL ELEMENTS 


The following designators reference special elements: 
* or *L 

■ Location counter 


*0 


Origin counter 


*F 


Absolute value obtained as follows: 

0 COMPASS assembler called by control 
statement 


1 COMPASS assembler called by the FORTRAN 
RUN compiler (no longer supported) 


2 

COMPASS 

compiler 

assembler 

called 

by 

the 

FTN4 

3 

COMPASS 

assembler 

called 

by 

the 

FTN5 


compiler. 

Special element *F can be defined differently 
by the F parameter in the COMPASS control 
statement. 


*P 


Position counter. Number of bits remaining in 
word: 1 through 60 for central processor pro¬ 
grams; 1 through 12 for peripheral processor 
programs. 


$ 


Position counter minus 1 
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DATA NOTATION 


Data notation allows you to enter numeric and character 
string values. 


DATA REPRESENTATION 


Character and numeric data can be represented as data 
items, constants, literals, or expressions. 

DATA ITEMS 

Data items are used in subfields of DATA and LIT, as 
specifications of length in VFD, and in register desig¬ 
nators . 

CONSTANTS 

A constant is an expression element consisting of a 
value in either octal, decimal, hexadecimal, or char¬ 
acter notation. Constants have these characteristics: 

The first character of the constant, as expressed 
in the program, is numeric. 

The field size is determined by the context in 
which the constant is used. The maximum field size 
is 60 bits (no double-precision floating-point 
numbers). 

LITERALS 

A literal is a read-only constant that is stored in the 
literals block. When a literal is used in an expres¬ 
sion, the expression is evaluated using the address of 
the literal rather than the value. 

Literals are specified either as data items in the LIT 
pseudo instruction or as expression elements preceded 
by =. 
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EXPRESSIONS 

expression is defined using elements and terms: 

An element is a symbol, constant, special element, 
register designator, or literal. 

A term is one or more elements joined by * (multi¬ 
plication) or / (division). 

expression is one or more terms joined by + (addi¬ 
tion), - (subtraction) and /s (logical difference). 

Register operators immediately precede register desig¬ 
nators and can be +, -, *, or /. 

CHARACTER DATA NOTATION 

Figure 1 shows the notations for character string data 
items, constants, and literals. 


An 


An 


NUMERIC NOTATION 

Figure 2 shows the notations for numeric data items, 
constants, and literals. 
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Data Item 


sign n type string 


sign type d string d 


Constant 


n type string 


Literal 


sign n type string 


sign type d string d 


- + or omitted 


Required for constant. Used for data 
item or literal not delimited by d 

0 Data item or literal terminated by , 
or blank 

Constant terminated by + - , * / blank 


n Decimal number of characters in the 
st r i ng 


Figure 1. Character Data Notation 
(Sheet 1 of 2) 
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Character string justification; for 
constant, C, L, and Z are the same. 

C Left justified, zero fill. 12 zero 
bits at the right of the last word 
guaranteed for data item or literal; 
no zero bits guaranteed for constant 

H Left justified, blank fill 

A Right justified, blank fill 

R Right justified, zero fill 


string 


L Left justified, zero fill 

Z Left justified, zero fill. 6 zero 
bits at the right of the last word 
guaranteed for data item or literal; 
no zero bits guaranteed for constant 

Characters between first and second 
occurrence of delimiting character com¬ 
prise the string; d cannot be r* 1 or = 

n characters following type or charac¬ 
ters delimited by d 


Figure 1. Character Data Notation 
(Sheet 2 of 2) 
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Data Item 


sign 

preradix 

value 

modifiers 


Constant 


value modifiers 




= 

sign 

preradix 

value 

modifiers 



sign 

preradix 


-, +, or omitted 

Optional for data items and 
literals; cannot be used for 
constants 

omitted Radix from assembly base 
or postradix 

B or 0 Octal notation 

D Decimal notation 

Octal or decimal digits optionally 
consisting of an integer, an octal 
or decimal point, and a fraction 

Octal or decimal point denotes 
floating point value in central 
processor assemblies only 


modifiers Optional modifiers in any sequence 


value 


postradix 
E+n, En, or E 


Same as preradix 

Single precision 
power of 10 


EE+n, EEn, or EE Double precision 

power of 10 


Sjji, Sn, or S 
P+n, Pn, or P 


Power of 2 scale 
factor 

Binary point 
position 




















PSEUDO INSTRUCTIONS 


COMPASS pseudo instructions are shown in table 2. 
Pseudo instructions have the same format as symbolic 
machine instructions; however, pseudo instructions 
control the actions of the assembler at assembly time, 
rather than the actions of the machine at execution 
time. 

In the placement column of table 2, first group refers 
to the first statement group. The first statement 
group must preceed any statements that define symbols, 
allocate storage, or generate object code. 
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TABLE 2. PSEUDO INSTRUCTIONS 
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CU 

XJ 

cu 

cu 

<1 

4-1 




4-J 

M 


PX 

i—1 

o 

X 


cd 

s 



d 

cd 


CO 

CU 

d 

cu 


£3 

Pd 

• 

• 

X 

rH 



iH 

o 

u 

** 


J23 

CO 

60 

O 

CJ 


CU 

CM 



o 

/'—n 

W 

d 

cd 

PX 

CU 


d 



cu 

ptf 

X 


o 

rM 


X 

• 

rH 

CU 

• 


o 

cd 

m 

X 

CM 

X 


0 

cd 

X 

X 



d 

M 

4-J 
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cd 
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CU 
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4-J 
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CM 
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cu 
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d 

M 

4-J 
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q 
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o 
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a 
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• 
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£ 
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P 
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O 
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0 

P 


cd 

p 
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P 
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p 

H 

N 

0 

(X 

£ 
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P 

w 
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0 

P 

CO 

W 


CO 

a) 
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rH 

50 

4-1 
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0 
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O 
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■ 

a) 

P 

X 
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P 
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O 

P 
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P 
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X 
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TABLE 2. PSEUDO INSTRUCTIONS (Contd) 





CD 

CD i—I 
*H cd 

i—I P 

cd 

p o 
co O 
M i—I rH 
■H (D d 
P O 


CO 3 

P T3 >>, 

•h d d 
cd cd 


o 



P 

CO 


p 



0 

• 


CD 



(D 



CD 

0 

i—i 

4-1 

CD 

i—i 

4-» 



P 

cd 

cd 

a 

4-J 

cd 

a 




p 

p 

cd 

d 

P 

cd 



'O 

60 

4-1 

p 

r~1 

4-1 

u 



0) 

o 

a 

cd 

o 

d 

cd 



> 

p 

CD 

r-» 

CO 

CD 



CO 

cd 

p. 

U 

Tj 

rP 

a 

CJ 


CO 

CO 

rQ 



cd 




cd 


d 

P 

4-J 


P 

4-J 


P 

Td 

CO 

<d 

CO 

p 

0) 

CO 


*13 

a; 


4-1 

P 

o 

4-» 

p 


T 'd 

0 

cd 

a 


CO 

u 


CO 

cd 

cd 

r—1 

cd 

*4-4 

CO 

cd 

4-1 

CO 

d 

rP 

p 


a) 

p 


a) 



cd 

cd 


a 

cd 

•*» 

P 

p 




i—i 



o 

?—i 




o 

o 


CD 


p 


cd 

cd 


p 

•H 



P 

60 

o 

■M 

p 

»H 

60 

o 

4-J 




d 

CO 

CD 

4-1 

P 

d 

C0 

CD 

r— { 
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o 

CO 


d 

CD 
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CO 

rP 

pP 


CP 

p 

CD 

cd 

(D 

> 
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CD 

cd 

0 
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rP 

a 


a 

O 

pp 

U 

rP 

CD 



4-> 

o 

(X 



4-1 

o 

PU 

CO 


CO 


p 

i—i 

CO 

P 


p 

1—1 

CO 


CD 

■— 1 

(X 

cd 

CD 

o 

1 — 1 

pw 

cd 

cd 


•H 




*H 







4-J 




4-J 
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CO 


•H 




■H 

cd 




CD 

• 
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4-1 
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(D 

d 

CD 



d 

60 

(D 
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r a 

CD 

0 



CD 
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cd 

o 

nd 
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r p 
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d 
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d 







HP 













CD 
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-H 

CU 



<U 

cn 

<D 


i—1 

p 


d 

P 

P 
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>1 


a) 


cd 

CU 

•H 

d 

t-H 

4-1 

rC 
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m 

CU rH 
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cn 

£ 

CQ 

a) 

£ 


3 O 

o 

p 

XJ S 

P 

d 

S 

4-1 

O CD 


*H 

c d 

*H 


0 

o 

M ^2 

Pm 

PM 

0 0 

Pm 

i — 1 

0 

!S 

60 CO 

o 


a) 

y 



cd 







P 






P 
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4-4 

cu 





rH 


p 



cn 


•H 

42 




p 

cd 


d 



p 


0 

Pm 




cu 

P 


Pm 

(U 


p 


d 

*H 




42 

<U 


0 

0 


cd 



P 





42 


O 

cd 


p 


60 

CU 





P. 


o 

0 


cn 


0 

P- 




d 

•H 







-H 






P 


o 

p 


X) 


cn 

o 




p 

CU 


o 

o 


0 


cn 

o 




•H 

Q- 


o 

cn 


0 


a) 

vO 



CO 

0 


■ 

vO 

cn 




a 




cn 

d 

S 



cu 


p 


o 




cu 


CU 

cd 

P 

a 


d 


p 

p 



p 

60 

p 

i—i 

CU 

o 


Pm 


p* 

<D 

<U 


XJ 

d 

cn 

P 

p 

p 


p 



P 

B 


XJ 

•H 


cu 

a 

Pm 


d 


i—i 

O 

0 

cn 

cd 

cn 

CO 

> 

cd 


cn 

o 


Cd 

cd 

0 

cn 


cn 


o 

p 

rH 

cn 



p 

p 


cu 


a) 

P 


cd 

cd 

cu 
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• 

a) 

cd 

p 

p 

p 

o 

cu 

p 

42 

P 

P 

p 

CD 

42 * 

42 

•H 

x) 

p 

o 

p 

o 

a 

cu 

x) 

cd 


Pm 

O 

0 

XJ 

d 

p 

d 


i 

42 

XJ 

d 

O 

•H cd 


d 

cd 

cu 
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cn 
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cd 
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cd 
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CD 
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42 

42 

CD 
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42 

a 

cn 
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■H 
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cn 

cd 
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o 
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cn 


cn 
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•H 

d 

cu 
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Pm 

X) 

p 

cd 


P 
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M 
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60 
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p 

Pm 

P 

o 
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0 
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d 
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w 
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TABLE 2. PSEUDO INSTRUCTIONS (Contd) 






4-J 

cu 



m 

4-1 

60 



•H 

cd 

a 



03 

o 

iS 



aj 

4-J 




«~H 





X* 

X 

• 



0 

•rH 

a 


HJ 

aj 

m 

o 


a) 

CO 

0 ) 

•rH 


C 

CO 

j-i 

4-J 


•H 

oj 

a 

•H 


4-1 



nd 

QJ 

QJ 

T3 

03 

a 

iH 

Td 

a 

3 

o 



cd 

C 

u 

cd 

a) 


•H 


■M 

V4 

4J 

0 

a) 

cd 

cd 

u 


03 

a 


cd 

cd 

• — i 

o 

<x 



cd 

i — i 

X 

o 

** 
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a) 

a) 


aj 
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4-1 


0 


4-J 


0 

CO 


CO 


CO 


u 

U 


M 


5-1 


0 

•H 


■H 


■H 


rC 

44 

0. 

4-1 

cu 

4-) 

Cu 

£ 


0 


P 


0 


4-> 

O 

4-1 

o 

4-1 

o 

0 

O 

u 

o 

5-4 

o 

u 

<3 

£ 

60 

a 

60 

£ 

60 


P< 

o 



CO 













• 


• 


O 

4-» 

CO 












O 


o 


4J 

•pH 

a) 












1 


+ 




CO 















60 

•rH 

0 



• 









60 


60 


0 

r-H 

cd 


• 

04 









0 


0 


*rl 

CU 

a 


pH 

o 









•rH 


*H 


XJ 

XJ 



M 










XI 


XI 


M 


X 

a) 


O 









0 


0 


O 

Xl 

*H 

0 

£2 

4-1 









i—1 


rH 


O 


uh 

54 

W 










a 


a 


O 

5-i 

(U 

4-1 


60 









0 


0 


0 

0 

54 


54 

0 











*H 



4-1 

P-* 

0 

O 

•H 













CO 

a 


0 


XJ 









«N 


r\ 


60 

cd 

CO 

43 

4-> 

54 









0 


0 


£ 

54 

0 

4-1 

a 

O 









o 


o 



cd 

0 


0 

a 

• 





rH 



•H 

• 

•rH 

m 

5-i 

43 

•pH 

54 

rH 

a 

pH 





0 



0 

Fh 

0 

Fh 

4-1 

O 

0 

CU 


0 

M 





0 



0 

H 

0 

M 

CO 


43 

5^ 


Q 





cr 


rH 

0 

Q 

0 

o 


cu 

<3 

4-1 

rP 

CNl 

£ 





0 


0 

14 

£ 

54 

£ 

U 

rH 


0 


(X w 







0 

CU 

W 

04 

w 

0 

60 


54 

4-1 

X 






54 


cr 

X 


X 

4-1 

0 

• 


0 

0 

>4 

0 




o 


0 

0 

54 

0 

54 

U 

*H 

CM 

0 

0 


o 

o 








O 


o 

cd 

co 

60 

CO 


4-1 


•H 



0 

0 


54 

0 


0 


5-i 


0 

I—1 

0 

0 

4-1 

4-1 



cfl 

0 


o 

> 

4-1 

> 

4-1 

cd 

0 

•pH 

0 

60 

0 

u 

•H 



A. 

rC 



*H 

O 


a 

rC 

43 

U 

m 

0 

•pH 

0 

XJ 


rH 

+J 

4-1 

0 

0 

4-1 

0 

4-1 

0 

o 

H 

4-1 


0 

0 

rH 

0 


0 



0 

0 

0 

rH 

•H 

i—i 



CO 

0 

Pi 

60 


O 


0 


54 

43 

43 

60 


0 


o 





0 


U 


cr 

a> 

0 

4-1 

4-1 

0 


O 

>N 

£ 

• 

Xl 

0 



Jb 


i—i 

0 

•u 

4-» 



0 

43 

04 

43 

4-1 


0 

o 

• 

r—1 


0 

cti 


n! 

0 

0 

0 






CU 

0 


0 

P- 

4-1 

0 

3 

4-1 

a) 

0 

0 

0 

54 

4-J 

54 

0 

CO 

O 



O 

X 

0 

54 

XJ 4 

o 

M 

54 

0 

0 

O 

0 

O 

0 

CD 

Ph 

r— < 


■rH 

0 

0 

H 

ta 

S2J 

o 

o 


iH 

MH 

0 

44 

0 

5-4 

M 

M .Q 

4-1 














cd 


0 

0 

•pH 

0 

0 








0 

0 

0 

0 

04 

a> 

•rH 

0 

XI 

4-1 

60 








4-1 

60 

0 

60 

S 

cu 

54 

CO 

0 

0 

0 








0 

0 

0 

0 

o 

CO 

4-1 

CO 

O 

0 

0 

Cul 

O' 

w 

H 

w 

EH 

W 

0 

0 

0 

0 

o 

V-/ 

CD 

0 

o 

H 

p2 

O | 

1 w 

2 

O 

o 

hJ 

►J 

H 

Pi 

EH 



0 

0 



o 

o 



0 

0 



1 —1 pH 

rH 
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*» 



0 XJ 

CM 



•pH CM 

04 

0 

0 

54 60 

X 

o 

a 

0 0 

0 

0 

0 

0 *rH 


pH 

rH 

xJ 54 

t—4 

** 

#\ 

~ 0 

04 

Cu 

04 

04 0 
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X 

X 

O XJ 
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0 



04 
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o 

O 
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P4 
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pH 
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M 

M 
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0 

0 
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•H 
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•H 
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TABLE 2. PSEUDO INSTRUCTIONS (Contd) 
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CO 




T-I 



■U 

PM ^ 

0 


CD 

O 0 



Ml 


CO 


*H 

••v 0 

X* 

O 

M-j 

PM U 

•H 

U 


0 o 

CO 

O 

M 

O rM 

0 

crt 

O 

Mi CD 

M 

0 

Pd 

00 Mi 





M 



















CD 







v4D 

4-1 











-U 








CO 

• 

m 


a) 







0 








Mi 

Mi 

o 


,J0 







CM 







rM 

•H 
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TABLE 2. PSEUDO INSTRUCTIONS (Contd) 
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SYSTEM MICROS 


The following paragraphs describe micros that are 
predefined by the COMPASS assembler. 


DATE 

DATE returns the 10-character date in the form 
A yr/mo/dy. or A mo/dy/yr., depending on installation 
parameters. The date returned begins with a blank and 
ends with a period. 


JDATE 

JDATE returns the five-digit Julian date in the form 
yyddd. 


TIME 


TIME returns the time in the form A hr.mn.sc. The time 
is 10 characters long beginning with a blank and ending 
with a period. 


BASE 


BASE returns the current base (D, M, or 0). The base 
is initially D. 


CODE 


CODE returns the current code (A, D, E, I, or 0). The 
code is initially D. 


QUAL 

QUAL returns the current zero- to eight-character 
qualifier symbol. The qualifier symbol is initially 
null. 


SEQUENCE 

SEQUENCE returns 18 characters comprising the sequence 
field (character positions 73 through 90) of the most 
recent source statement. 
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MODLEVEL 


MODLEVEL returns up to nine characters specified by the 
ML parameter on the COMPASS control statement. When no 
ML parameter is specified, MODLEVEL is identical to 
JDATE. 


PCOMMENT 

PCOMMENT returns the value specified by the PC param¬ 
eter on the COMPASS control statement; when no PC 
parameter is specified, PCOMMENT returns 30 blanks. 
When COMPASS is called by a language processor (such as 
FORTRAN), a string of characters supplied by the 
language processor is returned; this string usually 
contains information about compiler options. 
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CENTRAL PROCESSOR 0 
INSTRUCTIONS 

The following paragraph describe the central processor 
instructions. Compare/move and peripheral processor 
instructions are described later. 

Figure 3 illustrates the formats for 15- and 30-bit 
central processor instructions and the possible 
arrangements of instructions in a 60-bit central proc¬ 
essor word. 



15-bit instruction: 


14 

8 

5 

2 0 

fm 

i 

i 

k 

it instruction: 


29 

23 

20 

17 


0 

fm 

■ 

j 

K 


Arrangements of instructions in a 60-bit central 
processor word: 


15 

15 

15 

15 


30 

15 

15 


15 

30 

15 


15 

15 

30 


30 

30 





Figure 3. 15- and 30-Bit Central Processor 

Instruction Formats 
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The central processor instructions are shown in tables 
3 and 4. Table 3 lists the instructions numerically by 
operation code; table 4 lists them alphabetically by 
mnemonic. The symbols used in tables 3 and 4 are: 

A One of eight address registers (18'bits). 

B One of eight index registers (18 bits). BO is 
fixed and equal to positive zero. 

fm Instruction code (6 bits). 

i One of eight designated registers (3 bits). 

j One of eight designated registers (3 bits). 

jk A constant that indicates the number of shifts 
to be taken (6 bits). 

k One of eight designated registers (3 bits). 

K A constant that indicates the branch destina¬ 
tion or operand (18 bits). 

X One of eight operand registers (60 bits). 

Table 5 lists the central processor instructions that 
force upper. 

Some instructions in existing COMPASS programs are not 
valid for execution on the CYBER 170 models 825, 835, 
855, 865, and 875. You can specify S=AIDTEXT in the 
COMPASS control statement to detect these instructions; 
COMPASS flags the invalid instructions with a type 0 
error. S=AIDTEXT should not be specified if the 8 
option is chosen for the MACHINE pseudo instruction. 

An integer division macro IXi Xj/Xk is provided for 
central processor assemblies. This macro produces 
several words of code. 
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TABLE 3. CENTRAL PROCESSOR INSTRUCTIONS (NUMERICAL LISTING) 
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TABLE 3. CENTRAL PROCESSOR INSTRUCTIONS (NUMERICAL LISTING) (Contd) 
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TABLE 4. CENTRAL PROCESSOR INSTRUCTIONS (ALPHABETICAL LISTING) 
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TABLE 4. CENTRAL PROCESSOR INSTRUCTIONS (ALPHABETICAL LISTING) (Contd) 
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TABLE 5. CENTRAL PROCESSOR INSTRUCTIONS 
THAT FORCE UPPER 


Instruction 

Force Upper Occurs 

Before or After Assembly 
of the instruction 

Unconditional EQ 

After 

ES 

After 

JP 

After 

MJ 

After 

PS 

Before and After 

RE 

Before 

RJ 

After 

RL t 

Before 

WE 

Before 

WL t 

Before 

XJ 

Before and After 

Unconditional ZR 

After 

tNo force upper on SCOPE 2 
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COMPARE/MOVE INSTRUCTIONS 

The Compare/Move Unit (CMU) is a standard central 
processor hardware component of the CYBER 170 models 
172, 173, 174, 720 and 730, and the CYBER 70 models 72 
and 73. It provides central processor hardware for 
moving and comparing data fields that consist of 
strings of 6-bit characters. The CYBER 170 models 825, 
835, 855, 865, and 875 support compare/move instruc¬ 

tions through simulation. 

Data fields (strings) can: 

Span word boundaries 

Begin or end with any character position within a 
word 

Data fields cannot be in either the operating registers 
or in ECS/LCM/UEM. 

These symbols are used in the compare/move instructions: 

si String length in characters 

ks First word address of the source field 

kd First word address of the destination field 

ka First word address of the first field 

kb First word address of the second field 

cs Starting character position (0 through 9) in 

the source data field 

cd Starting character position (0 through 9) in 

the destination data field. 

ca Starting character position (0 through 9) in 

the first data field. 

Starting character position (0 through 9) in 
the second data field. 

The compare/move instructions are shown in table 6. 
Formats for the CC, CU, DM, and MD instructions are 

shown in figure 4. 

Each of the compare/move instructions causes a force 
upper before assembly of the instruction. IM also 
causes a force upper after assembly of the instruction. 
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TABLE 6. COMPARE/MOVE INSTRUCTIONS 
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PERIPHERAL PROCESSOR 
INSTRUCTIONS 

Peripheral processor instructions have two formats (see 
figure 5): 

The 12-bit format has a 6-bit operation code f and 
a 6-bit operand address d. 

The 24-bit format has a 6-bit operation code f (7 
bits for the CCF, CFM, SCF, and SFM instructions), 
a 6-bit d field (5 bits for the CCF, CFM, SCF, and 
SFM instructions), and a 12-bit m field. In many 
24-bit instructions, the d and m fields are com¬ 
bined to form the operand or operand address. 


12-bit PP instruction: 

11 6 5 0 


(P) 

F 

d 

bit PP instruction: 



11 

5 0 



11 

(P) 

f 

11 a 

11 d 



■ ■ 


11 

0 

(P)+1 

m 


Figure 5. Peripheral Processor Instruction 

Formats 
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Peripheral processor instruction listings are given in 
tables 7 and 8. Table 7 lists the instructions numer¬ 
ically by operation code; table 8 lists them alphabeti¬ 
cally by mnemonic. The following symbols are used in 
the instruction listings: 

d 

d itself 

(d) 

Contents of d 
((d)) 

Contents of the location specified by d 


m 


m itself used as an address 
m + (d) 

Contents of d are added to m to form an operand 
(jump address) 

(m + (d)) 

Contents of d are added to m to form the 
address of the operand 


dm 


18-bit quantity with d as the upper 6 bits and 
m as the lower 12 bits 

Some instructions in existing COMPASS programs are not 
valid for execution on the CYBER 170 models 825, 835, 
855, 865, and 875. You can specify S=AIDTEXT in the 
COMPASS control statement to detect these instructions; 
COMPASS flags the invalid instructions with a type 0 
error. S=AIDTEXT should not be specified if the 8 
option is chosen for the MACHINE pseudo instruction. 
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TABLE 7. PERIPHERAL PROCESSOR INSTRUCTIONS (NUMERICAL LISTING) 
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TABLE 7. PERIPHERAL PROCESSOR INSTRUCTIONS (NUMERICAL LISTING) (Contd) 
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TABLE 8. PERIPHERAL PROCESSOR INSTRUCTIONS (ALPHABETICAL LISTING) (Contd) 
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COMMON COMMON DECKS 


The common common decks are a set of COMPASS subrou¬ 
tines that: 

Convert data formats 

Manage tables dynamically 

Save and restore registers 

Provide an input/output interface at the Combined 
Input/Output (CIO) and File Environment Table (FET) 
level 

All of the common common decks run on NOS and NOS/BE; 
some run on SCOPE 2. 

Most of the common common decks are available as relo¬ 
catable subroutines that reside on the system library 
SYSLIB. To use these decks, relocatable central proc¬ 
essor programs need only include external references 
(=Xsymbol) to the entry points in the common common 
decks. The external references are satisfied from 
SYSLIB at load time. The CYBER Loader searches SYSLIB 
by default when satisfying external references; the 
SCOPE 2 Loader does not. Under SCOPE 2, you must 
specify SYSLIB as part of the library set (for example, 
through the LDSET pseudo instruction). 

The source code for all of the common common decks also 
resides on COMCPL; this source code references the 
system texts IPTEXT and CPUTEXT. COMCPL is an Update 
old program library. 

Table 9 shows, for each common common deck, the deck 
name, relocatable program name, entry point names, and 
availability under SCOPE 2. 
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TABLE 9. COMMON COMMON DECKS 



COMCMTM Managed table macros 
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TABLE 9. COMMON COMMON DECKS (Contd) 








DIAGNOSTICS 


T 



The COMPASS assembler produces two types of diagnostic 
messages: 

Fatal error messages (table 10) are flagged with an 
alphabetic character. 

Informative error messages (table 11) are flagged 
with a digit. 


TABLE 10. FATAL ERRORS 


Error 

Type 

Description 

A 

ADDRESS FIELD BAD. 


An error exists in a variable subfield 
entry. For example: 


CODE character not A, D, E, I, 0, or * 


Symbol or name greater than 8 characters 


Expression does not reduce to one external 
term; relocatable terms do not cancel 
properly; instruction disallows register 
designators; instruction requires absolute 
expression; and so forth. 


Data error: 8 or 9 encountered in octal 
data; modifier not S, P, 0, E, D, or B 


No data in variable field of LIT instruc¬ 
tion 


Relative jump out of range (-31>r>31) on 
peripheral processor instruction 


BASE character not 0, M, D, or * 


Register illegal in CON instruction 


Unable to locate synonymous instruction for 
OPSYN or CPSYN 


Micro count less than zero or greater than 

10 


N0LABEL character not I 
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TABLE 10. FATAL ERRORS (Contd) 


Error 

Type 

Description 

■ 

Negative relocation on 0RG or ORGC 

P0S value less than 0 or greater than word 
size 

Erroneous OPDEF reference 

No comma following DIS word count 

No symbol after =S, =X, or =Y 

Illegal entry in the variable field of 

1DENT 

D 

DOUBLY DEFINED SYMBOL. THE FIRST DEFINI¬ 
TION HOLDS. 

Symbol previously defined or declared ex¬ 
ternal. 

E 

ECHO, DUP, RMT, OR MACRO ILLEGALLY NESTED. 

Definition not wholly within next outer 
definition. 

F 

NUMBER OF ENTRIES EXCEEDS PERMISSIBLE 

AMOUNT. 

LIT generates more than 100 words 

Data missing or erroneous on XTEXT file 

More than 63 formal parameters and local 
names in macro definition 

More than 255 blocks 

More than 511 external symbols 

L 

LOCATION FIELD BAD. 

Required location field entry is erroneous. 

Format two macro definition has no substi¬ 
tutable parameters. 
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TABLE 10. FATAL ERRORS (Contd) 


Error 

Type 

Description 

N 

NEGATIVE RELOCATION ON ENTRY POINT. 

0 

OPERATION FIELD BAD. 


Instructions unrecognizable, out of sequence 
(for example, ABS or PPU pseudo instruction 
not in first statement group or instruction 
is illegal for binary mode), or relational 
mnemonic on IF statement is erroneous. Lo¬ 
cation symbol begins beyond column 2. 


As a result of the S=AIDTEXT compiler option 
or the MACHINE 8 pseudo instruction, COMPASS 
has determined that the instruction is not 
valid for the CYBER 170 models 825, 835, 

855, 865, and 875. 

P 

CONSULT LISTING FOR REASON BEHIND P-ERROR. 


Error flag generated by ERR or ERRxx pseudo 
instruction. 

R 

DATA ORIGIN OUTSIDE BLOCK OR IN BLANK 

COMMON. 


Attempt made to set data into blank common 
or beyond block limits. 

U 

UNDEFINED SYMBOL. VALUE ASSUMED 0. 


Reference to a symbol that is not defined; 
for example, IF statement line count, DIS 
word count, or unrecognizable attribute on 

IF statement. 

V 

BIT COUNT ERROR ON VFD (MUST BE 0 < COUNT 
< 60). 


VFD field size erroneous. 
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TABLE 11. INFORMATIVE ERRORS 


Error 

Type 


Description 






LOCATION SYMBOL BAD, SYMBOL NOT DEFINED. 

Location field entry erroneous. The 
instruction does not require an entry. 


ADDRESS ERROR ON SYMBOL DEFINITION. 

Erroneous variable field entry. The loca¬ 
tion field symbol is not defined. 


DUPLICATE MACRO DEFINITION. NEW ONE 
OVERRIDES. 

Macro, OPDEF, or synonymous operation 
redefines operation code. 


BAD FORMAL PARAMETER NAME IGNORED. 

Macro or ECHO formal parameter name 
repeated or illegal. 


CPU OPERATION SYNTAX INCORRECTLY SPECIFIED. 

OPDEF, CPOP, or CPSYN specifies illegal 
syntax. 


LOCATION FIELD MEANINGLESS. 

Entry in location field is ignored. 


ADDRESS VALUE EXCEEDS FIELD SIZE, RESULT 
TRUNCATED. 

Value of expression exceeds size of desti¬ 
nation field. 

BSS address expression value is negative. 

MICRO starting character position or char¬ 
acter count negative. 


MISSING OR EXTRA ADDRESS SUBFIELD. 

Variable subfield entry missing or super¬ 
fluous . 


MICRO SUBSTITUTION ERROR. NO SUBSTITUTION. 
Micro reference unrecognized. 
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CHARACTER SETS 


Table 12 shows the standard character sets used in CDC 
operating systems. 


60492800 D 


111 • 





TABLE 12. STANDARD CHARACTER SETS 
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